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INTRODUCTION 

1. WHAT IS BOOKI? 

2. WHAT CAN I USE BOOKI FOR? 
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WHAT IS BOOKI? 



With Booki you can create Books. Real paper books that look good and you can hold in your 
hands. You can also use Booki to produce books in the form of epub (electronic books), PDF, 
Open Office files, web pages and more... 



Booki is designed to help you produce books, either by yourself or with others. Booki is also a 
social environment where you can also discuss your views about producing books, seek 
assistance from others, look for projects to contribute to, seek others to help you, translate 
content and publish completed works. 

Booki supports the rapid development of content. You can use Booki to develop content in 
intensive 'Book Sprints'. Book Sprints are intensive collaborative events where 6-10 people 
focus on writing a book in 3-5 days. These collaborators might be in the same room or located 
around the net, in either case they work together simultaneously to produce a book rapidly. 

While you can use Booki to support very traditional book authoring processes, Booki was also 
developed to facilitate the accelerated production models enabled by Book Sprints. Hence the 
feature set matches the rapid pace of publishing possible in the modern era of print on 
demand. Using Booki, a book can be created in 2-5 days and then print ready source (book 
formatted PDF) can be generated in another 2-5 minutes, and then uploaded to your favorite 
Print on Demand service. 

Whether you are collaborating, writing in solo, rapidly developing books, or taking your time - 
when you have worked with Booki you will never think of publishing the same way again. 

Booki is developed by FLOSS Manuals and is Free Software licensed under the General Public 
Licence (GPL 2+). This means that it can be freely downloaded, re-used and customised. 
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WHAT CAN I USE BOOKI FOR? 



Booki supports any individual or group that wishes to write a book. Some typical uses of the 
platform might be : 

• Writing books - e.g. a Manual, a Cook Book, a Book about Fishing, a fictional tale. 

• Producing printed books 

• Producing ebooks 

• Writing any content as an individual. 

• Collaboratively authoring content. 

• Rapidly developing content in Book Sprints. 

• Customising existing content to apply to a very specific context. 

• Translating a book into another language. 

SIMPLE USE CASES 

Book Sprint 

I am working for rights of immigrant workers. We need to create a booklet about workers 
rights. I read the (free) FLOSS Manuals online manual on Book Sprints and then organise 5 staff 
to dedicate 3 consecutive days the following week. The first morning we each create an 
account. I have already created the new book, given it an open license, sent the others the 
URL, and prepared the Index. We spend 3 hours discussing the chapters and decide who will 
write what. At lunch on the first day we start writing. We continue to write for the following 2 
days. At the end of the last day we output an A5 book formatted PDF of 110 pages and take 
it to our local printer to make 500 stapled copies. Over the next 2 days peers from other 
offices log in to improve and build upon our work. We make the book formatted PDF freely 
available from our website to read or to print for distribution. Each of the other offices print 
copies locally and distributes them. 

Customising Content 

I am a developer that has contributed to several manuals on Free Software. My specialty is 
Drupal, and I have a client that I have just created a site for using Drupal. I want to create a 
manual for that client so I go to my user page and fork the existing FLOSS Manuals Groups 
manual on Drupal. I now have a standalone version of the manual on my account, any 
alterations I do will not be reflected in the original manual unless I merge the changes up 
stream. I remove several chapters not relevant to the client, add 4 new chapters that are 
specific to the client. I mark the new chapters as a€ceCopyright : all rights reservedaC and 
private so they are not reusable or seen by anyone else using the system. I write these 
chapters with information that is specific to my client and replace several existing screen 
shots in other chapters with screenshots of my clients site. I export the material to book 
formatted PDF, upload it to lulu.com print on demand service and buy 2 copies of the perfect 
bound book for my client. Later a potential client calls me for a meeting - I use my version of 
the Drupal manual, remove the client sensitive material, upload it, buy it, and bring the book 
to the meeting. 

Translating 



I am a volunteer translator. I want to translate a book on Mexican Cooking from the CookMe 
Group into French. I fork the existing manual from the CookMe Group to my user page. I force 
a machine translation of the content and mark all chapters a€ceto be translateda€. I message 
others subscribed to the Booki French group that I need some help and with 3 others we 
translate the material and mark all the chapters a€ceto be proofeda€ or a€cerequires 
technical proofingaC as we complete them. When we are finished I invite a friend to proof the 
content for us. She takes 1 week, doing it in her spare time. After each chapter is proofed she 
marks them a€cecompletea€. Later I output the translated book to book formatted PDF, 
upload to lulu.com and buy a copy. 

Multiple Formats 

I am an educator and have written a text book on digital design using Booki. While writing I 
kept the book private but invited select users to view the material and leave comments a€" 
this was great feedback for me. Now the book is completed and has been picked up by a 
publisher a€" I output an .odt file from Booki and open this in OpenOffice.org, save to a .doc 
format (the publisher does not know about free software) and send to them. I also negotiated 
a Creative Commons license for the material with the publisher. I release the book on my 
website using the embed api and invite translations. Within 4 weeks there is a completed 
Spanish translation which is uploaded to a print on demand service and sold through my 
website. A Portuguese translation is ready 3 weeks later. After an enthusiastic response to 
the Portuguese translation in Brazil I output the material to multiple column PDF suitable for 
printing on large format newsprint. A school district in Sao Paolo finds a local printer, 
downloads the PDF for free, and produces 1500 copies on newsprint and distributes for free 
around schools a€" this costs the same as printing or buying 30 printed books so I feel good 
and the schools make a huge savings. 

Portability 

I am invited to facilitate a Book Sprint on farming techniques in a remote area. The venue is a 
farm with no internet connectivity. I know a little about how to install web services so I 
download and install Booki on my laptop. At the Book Sprint we have 4 laptops connected to 
the local network version of Booki running on my machine. We write the book in 5 days. We 
output the book formatted PDF from my laptop, print the book at a local printer and 
distribute locally as educational materials. Later I upload the sources to the version of Booki 
running on my own server so others can access and reuse the content as they please. 

Organisational Documentation 

My organisation wants to review and upgrade it's documentation. We have decided to use 
Booki to collaboratively rewrite and update our content. Our IT Guru has installed Booki on our 
server so writers can login and update documentation from any machine. We will use the 
versioning feature to keep track of documentation versions as our docs grow and develop 
over time. When final revisions have been approved they are 'published' to screen readable 
PDF and Book Formatted PDF. The Book Formatted PDF is printed off for our 'official 
documentation' while the Screen readable PDF stored on our server for easy digital access by 
staff. 



USING BOOKI 



3. ACCESSING BOOKI 

4. NAVIGATING BOOKI 

5. READING A BOOK 

6. CREATING AN ACCOUNT 

7. MY SETTINGS 

8. JOINING A GROUP 

9. CREATING A GROUP 

10. CREATING A BOOK 

11. IMPORTING A BOOK 

12. ADDING A BOOK TO A GROUP 

13. CREATING CHAPTERS & SECTIONS 

14. EDITING A CHAPTER 

15. CREATING AND EDITING THE TABLE OF CONTENTS 

16. COMMUNICATION 

17. PUBLISHING 

18. LICENSING 



3 



ACCESSING BOOKI 



Booki can be accessed in several ways: 

• Firstly, the Booki web page provides hosting for many groups and books and is found at 
http://www. booki. cc; 

• Your organisation may have installed a copy of Booki on their own server. In this case 
access would be made through a url provided by your organisation. 

• Like in the Portability use case outlined in the 'How can I use Booki?" chapter, you 
may have Booki installed on your own computer. In this case you would use the url 
created when you installed Booki. 

□ 

Slpg; The Booki Home Page 

Once you have arrived the home page, most functions can be accessed via the Menu down 
the left hand side of the window. 



Fig: The Booki Menu 
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NAVIGATING BOOKI 



Navigation around Booki is pretty easy, on the left hand side of the web page is the menu, 
this is used to access most areas of Booki. When reading a book, there is a table of contents 
running down the left hand side of the reading pane which is used to navigate between 
chapters. 

MENU TOOL-BAR 

The Menu is split into 2 sections, the top section can be viewed and navigated by anyone 
visiting the website, the bottom section can only be accessed by a user logged into Booki. 

SGeneral Navigation 

About 

This is Booki's home page 

Books 

This link loads a list of all books created and stored on the Booki server. From there you can 
click on any book title for reading or editing. 

Groups 

Loads a list of all the groups that have been created. You can link to the Group-page of any 
group found here by clicking on it's name. On the Group-page you can see a lists containing all 
the members of the group and all the books that have been added to the group. 

People 

Displays a page listing all the people who have signed up with Booki. Clicking on a person's 
name will take you to their profile page. 

User Navigation 

My Profile 

loads a page displaying your profile, here you will see lists of books you have created or 
imported, groups you are a member of as well as areas where you can create or import new 
books and create new groups. 

My Settings 

Displays a page where you can alter your user settings such as your email address and a blurb 
about yourself. 

My Books 

Loads a list of all the books you have imported or created from scratch. You can also import 
an existing book from another source or create a new book from the My Books page. 
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My Groups 

Displays a list of all the groups you have joined. You are also able to create new groups from 
this page. 

My People 

This page is yet to contain any content. 
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READING A BOOK 



Reading a book that has been created, imported or edited with booki is easy. You don't need 
to create an account to read a book, just follow these simple steps. 

1. Go to the Booki home page www.booki.ee. 

2. Click on Books in the menu running down the left-hand side of the page. 



3. Click on the title that you would like to read. 

o you are taken to the reading screen for the book. 

4. A list of chapters runs down the side of panel, click on the chapter you want to read. 

o the chapter loads into the main panel of the screen for you to read. 

Because the list of books on the Books page is large, it could be easier to click on Groups 
from the menu and then choose a group from the Groups-list. Finally pick the book you want 
from the Books list on the Group page. 
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USE CASE 

e.g. You are a fan of classic English literature, recently you heard from a friend that a lot of 
literature with expired copyright has been added to Booki by the English Literature group. 
Always in search of a good read, you navigate to www.booki.cc.and once there you click on 
Groups. When the Groups-list is displayed you click on the English Literature group, taking you 
to their Group page. You browse their Book List and notice that they include Alice's 
Adventures in Wonderland. As this was a childhood favourite of yours you click on the Books 
title taking you to it's reading page, you click on Chapter I - Down the Rabbit Hole and start 
reading. 

m l 
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CREATING AN ACCOUNT 



After arriving at Booki you will need to create a user account before beginning the creation 
and editing of books. 

Account generation is simple: 

FROM WITHIN BOOKI 

1. On the front page click on Sign in / Create Account at the top of the screen. 

2. Under Create Account add your desired USERNAME, E-MAIL, PASSWORD + 
CONFIRMATION and then your FULL NAME. 

• Your full name is required for registration as it is used for copyright attribution on any 
works you create or contribute to. 

• click Create Account. 

• Booki will generate the account and display a Your account has been created message 
before redirecting you to your Profile Page. Your user page is also accessed through My 
Profile on the menu. 

REDIRECTION FROM OUTSIDE BOOKI 

Organisations that have generated a group in Booki have the ability to redirect you to the 
Booki Create Account page from their website. If the link for this link is set up properly you 
will also be added to their group automatically when you create your account. 

USE CASE 

From within Booki 

You are a keen gardener and have a lot of knowledge to share, hearing of Booki you decide to 
create an account and write books about gardening. Upon accessing the Booki home page 
you click on the Sign in / Create Account link and fill in your Username, E-Mail, Passwords 
and Full Name before clicking Create Accoun to complete the process. You are now able to 
create, import, edit and contribute to books on Booki. 

From outside Booki 

You have read some of the great manuals produced by FLOSS Manuals and want to join them 
so you can also contribute to new manuals about free software. On the Floss Manuals 
website when you click to register it redirects you using the following link: 
http://w ww. booki. cc/accounts/signin/?redirect=/&group=f loss- manuals . You now find yourself 
at the Booki Create Account page with a note below the Registration form saying that you will 
automatically be added to the FLOSS Manuals group when you create an account. You fill in 
your details and click on Create Account. After being redirected to your Profile Page you see 
that FLOSS Manuals is displayed in your Groups List. 
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MY SETTINGS 



Once you have created and account you can edit a number of settings to customise your 
appearance on Booki and to help communication with the members of any groups you may be 
a part of. 

MY SETTINGS PAGE 

To view your settings click My Settings on the menu. 

<insert pic of my setings> 

When you first enter this page you will see a generic image in the top left corner along with 
your email and full name you entered when creating your account. 

On the right hand side of the panel you can edit your email and full name if either of those 
were typed in incorrectly or if they change in the future. 

Below your full name is a text box where you can type in a blurb about yourself, and at the 
bottom of the page you can browse your computer for an image to upload for Booki for use in 
your profile. 

Once you have made the changes you want to your settings click Save user profile to save 
your changes. 

MY PROFILE PAGE 

The last user setting you can change is found on the My Profile page accessed from the 
Menu. Once the page has been loaded you will see in the top right hand corner of the page a 
text box asking What's on your mind ? You can click in this box and add any comment 
about how you are feeling and what you are thinking about, then click on Share to save the 
comment. This now appears under your full name on your My Profile page. And it also 
appears under your Icon in the Currently editing list when you are editing a chapter in a 
book. 

USE CASE 

After creating your new Booki account you click on My Settings. Once the page has loaded 
you click in the Blurb about yourself box and type a couple of sentences about your passion 
for organic gardening. You then click on the Browse... button next to Image and navigate to 
your Pictures folder. Here you find a picture of yourself holding a couple of bunches of organic 
grapes you have grown and decide to use this as your profile image so you select the image 
and click open. You now click Save user profile to save your changes. 

No that you have finished the changes in My Settings you click on My Profile. When your 
profile page has loaded you click in the box that says What's on your mind ? and type in "I've 
always got Gardening on my mind!" before clicking on Share. In the top of your profile page 
beneath your new image, email address and name is your new statement I've always got 
Gardening on my mind!. This statement will also appear beneath your name in a currently 
editing list that is displayed when you are editing a book. 

■ 
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JOINING A GROUP 



After joining Booki you may want to jump right in and create a book that will be listed under 
your name. However, Booki has the ability to organise groups together to create books that 
share a common theme or interest. 

One example of a Group would be an Organic Gardening group, the group was formed to write 
books about different aspects of organic gardening.encouraging people to start their own 
organic gardens. Organic Gardeners have joined the group to help contribute their expertise in 
the creation of these books. A selection of titles created by the group may include: Growing 
Vegetables, Creating Your Garden, Composting, Growing Fruit Trees, Pest Control and 
Ornamental Gardens. 

To Join a Group: 

1. Click on Groups in the menu. 

2. Find the group you want to join in the Groups-list and click on it. 

3. On the Group page click on the JOIN THIS GROUP button at the bottom of the main 
panel. 

4. You are added to the group and will see your name appear under the Members list. 

A group also has the ability to format a Hyperlink for Creating an account so when someone 
uses the link to register with Booki it also automatically adds them to a group. For Example if 
FLOSS Manuals adds the following link to the registration page on it's website: 
http://www. booki. cc/accounts/signin/?redirect=/&group=floss-manuals , it will redirect the new 
member to Booki's Create Account page. At the bottom of the registration form a note is 
displayed informing the new member that they will also be added to the FLOSS Manuals group 
when they click on Create Account. 

REMOVING YOURSELF FROM A GROUP 

At some point you may want to remove yourself from a group. 

1. Go to the Booki home page and click on the link to the Group that you want to be 
removed from. 

o You can also find the Group from your Profile Page, it will be included in the Group 
list. 

2. On the Group page click on REMOVE ME FROM THIS GROUP. 

o You will be removed from the group and your name will disappear from its 
Members list. 

CASE USE 

As an experienced gardener you have recently heard about Booki and the Organic Gardening 
group through a blog page on a gardening website. You have accessed the Booki web page 
and just finished creating your account and now want to join the Organic Gardening group. 

1. You click on the Groups link in the menu taking you to the Groups-list. 

2. On the Groups-list page, you find the Organic Gardening group and click on its link. 

3. This takes you to the Organic Gardening group page, you click on JOIN THIS GROUP and 
see your name added to the Members list. 
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CREATING A GROUP 



Sometimes the group you want to join isn't there yet, so this is your opportunity to blaze a 
trail and start up a group of your very own. 

1. Click on My Profile in the menu 

• Once the page loads you will see the bottom right section of the page is labelled Create 
new group. 




• In the Group name textbox type in a name for your group and then type in a brief 
description in the What is this group about box below. 

• Be sure that you have everything entered as you want it as currently Booki doesn't let 
you change your settings once the group has been created. 

• Finally click on the Create new group button at the bottom of the page. 

• Your new group will be added to the Groups list on your page and you can click on it to 
take you to the group page. 

USE CASE 

You are a primary school teacher and for a class project you want your students to work 
together creating a Book outlining the results of their research. Your hope is that the finished 
document will able to be used as a learning resource for future classes. To ensure that only 
your class are the editors you decide to create a group that the class will use for their 
project. You log in to Booki and click My Profile in the menu. You enter "Room 4 Class 
Projects" into the Group name text box and then type in "Students from room 4 at Sildale 
Primary School use this group to create Books based on class projects." into the What this 
group is about text area. After clicking Create new group you see the group is now added 
to your groups list. You finally click on the group name "Room 4 Class Projects " which takes 
you to the group page. 

■ 
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CREATING A BOOK 



There are two ways to create a project in Booki. The first is to create a new blank book and 
the second is to import a book from Archive.org, WikiBooks or any epub file. In this chapter 
we will look at creating a new blank book and then explore importing books in the following 
chapter. 

Once a user has created an account they can manage the creation of books from their user 
page. This is as simple as entering the title of the book in the field provided and then choosing 
the desired license from the drop down menu. 

H 

1. Click on My Profile in the Menu to go to your user page. 

2. Under Create new book enter the title for your Book and then select the Licence for 
the book from the Drop-down list. 

o For more info on licences and which ones to use when - see the chapter on 
Licensing. 

3. Once you press Create, the book will then be generated and listed under the Books 
heading on your user page. The book has by default no chapters, sections, or content. 

Note: If you try to create a book with the same title as a book that has already exists, booki 
will add '-/' to the end of the title and try again, then if the new title also already exists it will 
try '-2'... '-3'... and so on, until it finds a title that has not yet been created. 

USE CASE 

As an organic gardener you have had a lot of experience growing grapes. After joining the 
Organic Gardening Group you decide to start a book based on your particular experience. You 
access your Profile page via My Profile in the Menu and once the page has loaded you type in 
the title "Growing Vine Fruit " under Create New Book. Because you are passionate about 
organic gardening and want as many resources as possible to be available for people who want 
start organic gardening you decide to use the Creative Commons CC-BY-SA licence. This 
licence allows anyone else to use the text in the book, either just to copy or for use in their 
own creation (for example another book on organic gardening), so long as they cite your book 
as the source of any material used and they also use the CC-BY-SA licence on any works they 
create using material from your book. You now click Create and complete the generation of 
your first book! 
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IMPORTING A BOOK 



Books can be imported from several sources, Archive.org, WikiBooks, and epub files. In 
this chapter we go through each of these scenarios. 

Note: When importing text into Booki from it's respective locations and formats it is important 
to note that the document structure may not be a part of the source file. This would leave 
the entire text in a single chapter which will need to be broken up into its individual chapters 
and Sections once in Booki. 

Note: If you try to create a book with the same title as a book that has already exists then 
Booki will add '-/' to the end of the title and try again, then if the new title also already exists 
it will try '-2'... '-3'... and so on, until it finds a title that has not yet been created. 

ARCHIVE.ORG 

The Internet Archive is a a non-profit digital library storing digitised collections of websites, 
music, moving images, software and books. With its stated mission of "universal access to all 
knowledge ." , its purposes include offering permanent access for researchers, historians, 
scholars, people with disabilities, and the general public to historical collections that exist in 
digital format. 

On your My Profile page under Import from Archive.org enter the Archive id and press 
Import. 

• The Archive id can be found in the Identifier field under the Selected metadata 
section at the bottom of the text's page on Archive.org. 

The text is now imported from Archive.org using Espri and converted into a Booki-zip file (this 
may take a while). Once the process has finished the imported book will be added to the list 
of books on your My Profile page. 

EPUB DOCUMENT 

ePub, short for Electronic Publication is an open standard e-book format, that has the ability 
to optimise the text display for whichever device is viewing the book. Booki has the ability to 
import any document in ePub format (note: although ePub is an open format, not all books 
available in ePub format have open licences so care needs to be taken when choosing to 
import an ePub document that it contains a permissive copyright). 

To import an ePub document, first you need to get the url for the ePub book, then copy it's 
location. 

• On your User page in Booki, paste the ePub url into the Url field under Import epub and 
click Import. 

The text is now imported using Espri and converted into a Booki-zip file (this may take a 
while). Once the process has finished the imported book will be added to the list of books on 
your My Profile page. 

USE CASE 

Archive.org 
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You have recently joined the Organic Gardening group and have gone in search for already 
compiled texts that could be used to booster the number books available under Organic 
Gardening. Searching through Archive.org you find a book on gardening from 1847, entitled 
"The Family Kitchen Gardener" by Robert Buist. Due to it's age, you have a suspicion that it 
may pre-date all the chemical methods employed by modern conventional gardening and 
therefore contain natural organic methods for growing edible plants. A brief read confirms this 
suspicion and also reveals that there are areas of the text that could do with tidying up as 
well as some updating for the 21st Century, cementing it as a great candidate for importing to 
Booki. 

1. You navigate to The Family Kitchen Gardener 's page on Archive.org 
(http://www.archive.org/details/RobertBuiststheFamilyKitchenGardener1847) 

2. You scroll down to the bottom of the page where you find the section called Selected 
metadata. 

3. Here you can see that the Identifyer is: RobertBuiststheFamilyKitchenGardener1847. You 
copy the Identifier and then go to your My Profile page on Booki. 

4. Under Import from archive.org you paste the Identifier into the Archive id field and 
click on Import. 

5. Booki takes a couple of minutes importing the book and when it is finished you see The 
Family Kitchen Gardener listed under Books on you My Profile page. 

6. You can now click on it's title in the Books list to start reading. 

ePub document 

After importing The Family Kitchen Gardener you have been looking through Project Gutenberg 
(www.gutenberg.org) and have found a book entitled "Culinary Herbs: Their Cultivation 
Harvesting Curing and Uses" by M. G. Kains Originally published in 1912 it contains a lot of 
information not only around growing herbs, but also ways to treat, store and use them and 
provides a fantastic base for a book on organically growing herbs. 

1. After loading your Profile page in Booki, you open a new tab or window in your web 
browser. 

2. In the new Tab/Window you navigate to the home page for Culinary Herbs: Their 
Cultivation Harvesting Curing and Uses (http://www.gutenberg.org/ebooks/21414) 

3. Once here you scroll down to the Download this ebook for free section of the page. 
Under the Computer-generated files list you see two epub versions of the book one with 
pictures and one that is plain text. 

4. Thinking that it would be easier to remove any unneeded or unwanted pictures than to 
add new ones later on, you decide to import the version with pictures. You right-click 
on the main site link in the EPUB with images row of the list and click on copy link 
location (firefox, ...) or... (ie, ...), or... (safari, ...). 

5. Going back to the tab/window containing your profile page you paste the copied link into 
the url textbox under Import epub, then click on Import 

6. Booki takes a couple of minutes importing the book and when it is finished you see 
Culinary Herbs: Their Cultivation Harvesting Curing and Uses listed under Books on you 
My Profile page. 

7. You can now click on the edit link next to it's title in the Books list to start editing the 
newly imported book. 
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ADDING A BOOK TO A GROUP 



Once you have created or imported a book into Booki, it will sit in the Books list on your user 
page. As a member of a group often you will want the book that has been created to sit in 
the Group's list of books as well. 

NOTE - A Book can only belong to one group at a time. 

To add a book you have created or imported to a group: 

1. On your Profile page, click on the link to the Group you want to add your book to in the 
Groups list. 

o You can also use the Groups link or My Groups link on the Booki home page to 
access a Groups list containing the link to the Group you want to add your book 
to. 

2. Once the Group page has loaded you will see a drop-down list containing the titles of 
books that you have either imported or created. 

3. Click on the list and select the book you want to add to the Group 

4. Now click ADD THIS BOOK TO GROUP 

o Your book now appears under the Books list on the Group page. 

REMOVING A BOOK FROM A GROUP 

At some point you may want to remove a book from a group. On the group's page under the 
Books list you will see a remove link next to your book. Click on the link and your book will 
disappear from the list. 

USE CASE 

As an organic gardener with a lot of experience growing grapes, you have just created a new 
book called Growing Vine Fruit. You now want to add this book to the Organic Gardening 
group, along with two books you have recently imported into Booki ("The Family Kitchen 
Gardener" by Robert Buist and "Culinary Herbs: Their Cultivation Harvesting Curing and Uses " 
by M. G. Kains), not only will it help end readers to find the books, but it will also encourage 
collaboration on the books from other members of the Organic Gardening group. 

1. On your Profile page you click on the Organic Gardening link in the Groups list. 

2. Once the Organic Gardening group page has loaded you click on the drop-down list 
containing the titles of books that you have either imported or created and select 
Growing Vine Fruit and click on ADD THIS BOOK TO GROUP. 

3. You Repeat Step 2. for The Family Kitchen Gardener and then Culinary Herbs: Their 
Cultivation Harvesting Curing and Uses. 

4. On the Organic Gardening Group page you now see all three titles added to the Groups 
list. 
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CREATING CHAPTERS & SECTIONS 



Chapters are where the content of your book will reside. Each chapter generally contains 
content on a specific topic or group of topics indicated by its title. In a story or novel each 
chapter often treated like an individual scene in a film, advancing the plot one step closer to 
the climax. 

THE EDITING PAGE 

Once a new book is created click on the edit link next to the title of the new book on your 
Profile page to open the book's Editing page. 

• to open the Editing page for a book someone else has created, click on the Books link in 
the menu, click on the book you want to add a chapter to from the list on the Books 
page and then click on the EDIT link. 

At the top of the Editing page is the Book's Title. Below the Title, you will see a selection of 
tabs: Chapters, History, Notes and Publish. During the editing phase of our book we will be 
primarily focused on the Chapters tab, this is where you can view the layout of the book and 
then access and edit its individual chapters. The History tab shows a list of all the changes 
made to the book since it's creation. In the Notes tab you can leave notes to yourself or 
other authors about what you want to do with the book or an outline of it's intended 
structure, we will explore this feature further in the Communication Chapter. Once a book 
is finished you can use the Publish tab to export your book to variety of formats including 
Book formatted pdf to send to a commercial printer, epub for use with electronic readers and 
HTML to embed the book into your personal web page (for a full list of publishing options see 
the Publishing Chapter). 

Inside the the Chapters tab, the page is divided into two areas, the top area is the Table of 
contents and the bottom area is called Hold chapters. When a chapter is first created it is 
automatically placed into Hold chapters and stays there until you are ready to publish that 
chapter. Any chapter residing in Hold Chapters will not be visible in you books Reading page 
and will not be included when you publish your book (e.g. creating a book or web formatted 
pdf, or epub) 

CREATING A CHAPTER 

1. In the Chapters tab on the editing page click on NEW CHAPTER at the top or bottom 
of the Table of contents. 

2. The New chapter window opens, enter the Title of your new chapter and click Create 
chapter. 

3. The new chapter is created in the Hold chapters section at the bottom of the Table of 
contents. 

USE CASES 

After adding your new book titled "Growing Vine Fruit " to the Organic Gardening group it is 
now time to create the first chapter for the book. 
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1. On your Profile page click on the edit link next to the book title Growing Vine Fruit . 

2. Once the Chapters tab in the Editing page for Growing Vine Fruit opens you click on 
NEW CHAPTER. 

3. When the New chapter window appears you type in "What is Vine Fruit " as the Title 
for your first chapter and then click Create chapter. 

4. The new chapter "What is Vine Fruit " appears in the Hold chapters section at the 
bottom of the Table of contents. 
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14. 



EDITING A CHAPTER 



Once you have created chapters, content needs to be added to them in the form of text and 
images. This is where you will be spending most of your time in Booki, writing new chapters, 
reviewing chapters, editing chapters and updating chapters as well as inserting and organising 
images in a chapter. 

ACCESS CHAPTER EDITOR 

1. First you need to be in the Editing page for the book you are working on. 

2. Make sure the Table of contents is visible by clicking on the Chapters Tab. 

3. Then click on the EDIT link next to the chapter you want to edit. 

4. The Chapter editor opens showing the Chapter Title and any content that has already 
been added. 

MAKING CHANGES TO A CHAPTER 

Once the chapter editor opens, just start typing to write or edit the chapter. If you are 
writing a brand new chapter a good practice is: 

1. Get all your text and ideas typed in first. 

2. Once all your content is in go back and and add the formatting such as headings, bold 
and italic styling, lists, tables, etc. 

3. When you have formatted the chapter go through it and work out where you require 
images and what images you require. 

• It can be useful to add in a little note in the spot where you want to add an image a 
description of the image to be added, e.g. --Insert image showing editing toolbar-- 

--Insert image displaying comment within the text-- 

• Now go and obtain/create the required images and upload them to Booki, before inserting 
them into the chapter. 

• Finish off by reviewing the chapter making sure there are no spelling errors, it makes sense, 
and it is relevant to the intended audience in terms of language and content (i.e. is the book 
aimed at primary school children or at adults who have completed university degrees; 
someone brand new to computers or someone with experience in software development). 
The ins and outs of the Chapter editor and Image management will be explored in the 
Chapters ---insert chapter titles here--- . 

SAVING YOUR WORK 

As with every other software application you need to save your work regularly to avoid losing 
those hours worth of effort due to your laptop battery going flat or some similar incident. 

Booki has three buttons concerning saving your work which are located at the top of the 
Chapter editor. They are Save, Save and continue editing and Cancel. 

Save 

clicking on Save will not only save your changes to the chapter, but will also close the Chapter 
Editor and return you to the Book's Table of contents. 

Save and continue editing 
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This button is extremely useful, when it saves your changes it leaves the editor open for you 
to continue making changes to the chapter. This is the button to use regularly to ensure you 
don't lose the changes you have made to the chapter. 

Cancel 

This button is only used if you decide that you don't want to keep the changes that you have 
made to the chapter. 

USE CASE 

You have created the first few chapters for your book "Growing Vine Fruit " for the Organic 
Gardening group and are now ready to start writing. 

1. On your profile page you click on edit next to Growing Vine Fruit in your Books list. 

2. Once the Table of contents has loaded you click on EDIT next to the introduction 
chapter "What is Vine Fruit? " 

o The text editor loads with the heading What is Vine Fruit displayed. 

3. You begin typing your chapter. 

o Every few minutes you click Save and continue editing to make sure you don't 
loose anything you've written. 

4. After you have all the text typed in that you feel necessary for this chapter you give it 
a brief review adding in any formatting where necessary. 

5. At this point you don't feel the need to add pictures to the Introduction so having 
finished your chapter you click on Save to exit the text editor and save your changes at 
the same time. 

--Need to decide where this last paragraph will go-- 

To change the title of your chapter, double click on the title in the Table of contents page. 
You can now edit your chapter title. Click on 'Save' to keep the changes or 'Cancel' to reject 
them. 

--I am currently thinking it should be in the Creating and Editing the Index chapter-- 
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15- CREATING AND EDITING THE TABLE 
OF CONTENTS 

Once several chapters have been created and developed, it is time to organise and order your 
Table of Contents. 

ADDING SECTIONS TO YOUR TABLE OF CONTENTS 

On the Book Editing page your newly created chapters will be sitting under the Hold 
chapters section, but before you add your chapters to the Table of contents, you may want 
to create separate sections for these chapters to sit under. The sections could have titles 
such as Introduction, Advanced Features, Appendix, or whatever best suits your content, then 
one or more chapters can be added to each section. 

• As you can see with the Booki User Guide, it has been divided into 3 Sections: 

Introduction, Using Booki and Contributing to Booki. The first section only has 2 chapters 
that introduce the reader to Booki: what is it; what can it do; and where can it be used. 
The second section Using Booki contains the bulk of the chapters and instructs the 
reader how to use the various features of Booki from creating an account through book 
creation and editing to publishing a book. The third and final section Contributing to 
Booki contains a couple of chapters for those interested in helping develop the Booki 
software and Documentation. 

To add sections to a book, first you need to navigate to it's editing page, either via your 
Profile page or use the Books link in the menu to find and work on a book created by 
someone else. 

1. On the editing page click NEW SECTION at the top or bottom of the Table of 
contents. 

2. The New section window opens, enter the title of your new section and click Create 
section. 

3. The new section is created and placed at the bottom of the Table of contents. 

ORGANISING THE TABLE OF CONTENTS 

Hold Chapters 

Inside a book's Chapters tab, the page is divided into two areas, the top area is the Table of 
contents and the bottom area is called Hold chapters. When a chapter is first created it is 
automatically placed into Hold chapters and stays there until you are ready to publish that 
chapter. Any chapter residing in Hold Chapters will not be visible in you books Reading page 
and will not be included when you publish your book (e.g. creating a book or web formatted 
pdf, or epub) 

Re-ordering Sections and Chapters 

If your sections need to be re-ordered click and hold on the up/down arrow at the left of the 
Section bar you wish to move, then drag the section up or down to get to it's rightful place. If 
you need to delete a section, drag it into the Hold chapters area of the Chapters tab. 
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Once the book's sections have been set up you are able to use the same technique to drag 
your chapters from the Hold chapters area into the correct section of the table of contents. 
If there are any chapters you are unsure about or want to make significant modifications to 
you can drag them back to the Hold chapters area so they wont appear in the Table of 
Contents on your Book's Reading Page. 

Deleting Sections and Chapters 

To delete a section, use the above method to move it into Hold Chapters once in there it will 
be deleted. 

Currently chapters can't be deleted from Booki, but to prevent them from appearing in a 
book's Reading page or from being published drag them into Hold Chapters. 

EDITING CHAPTER AND SECTION TITLES 

Once a chapter or section has been created, you may not always like the title or you might be 
re-organising the entire book and therefore chapters and sections need to be re-named for 
the new structure. Renaming is the same for both chapters and sections: 

1. Open your book's Edit page and make sure the Chapters tab is selected. 

2. Double-Click on the chapter or section name that you want to change. 

• A text field opens allowing you to change your title. 

• Make any changes you desire and then click on the SAVE button to the right of the text 
field. 

• CANCEL will of course cancel any changes made and return you to the previous title. 

USE CASE 

Creating a Section 

After creating a few chapters for Growing Vine Fruit you decide it is time to add some 
structure to the book by dividing it into sections, after some thought you come up with the 
following sections to add to the book: Introduction; Developing Your Soil; Planting and Early 
Growth; Pruning and Mature Growth ; and Harvesting and Propagation . Now you need to add 
these sections to your book 

1. On the Editing page for Growing Vine Fruit you click on NEW SECTION in the Chapters 
tab. 

2. In the New section window you type in "Introduction" and click on Create section. 

3. Introduction appears at the bottom of the Table of contents. 

4. You click on NEW SECTION again and this time type in "Developing Your Soil". 

5. When you click Create section Developing Your Soil appears at the bottom of the 
Table of Contents Below the Introduction section. 

6. You repeat step 4 and 5 for Planting and Early Growth , Pruning and Mature Growth , and 
Harvesting a Propagation. 

Moving Chapters 

Now that the sections have been created you want to move your first chapter "What is Vine 
Fruit" from Hold chapters into the Introduction section. 
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1. You hold down the left mouse button on the up/down arrow to the left of the What is 
Vine Fruit chapter title. 

2. You then Drag the chapter from Hold chapters up to the Table of contents and keep 
moving until it is sitting directly below the Introduction section title, before releasing the 
left mouse button. 

3. What is Vine Fruit is now sitting in the Table of contents as the first chapter in the 
Introduction section of your book. 

Renaming a Section 

After placing What is Vine Fruit in the Introduction section you decide that the section title 
Introduction doesn't fit in with your plan for the book and will change it to "Getting to Know 
Vine Fruit" 

1. You double click on the section title "Introduction" 

2. The title bar changes to a text box containing the word Introduction. 

3. You delete Introduction and type Getting to Know Vine Fruit before clicking SAVE. 

4. The title bar returns to normal displaying the new section title Getting to Know Vine 
Fruit. 
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16. 



COMMUNICATION 



When collaborating on a book, communication is a vital part of the process, whether working 
in a book sprint, taking your time on more long-term book generation, working locally in the 
same physical space or remotely online. These situations have different requirements and 
harmonising these into one system is where FLOSS Manuals has done a lot of real world 
research and Booki will take the best of what we have learned. Booki includes tools such as 
real time edit notifications to see who is editing what at this moment, a real time chat (web / 
IRC gateway), system level notifications, chapter status markers, book progress indicators, 
work flow tools, and live user status listing 

REAL TIME EDIT NOTIFICATIONS 

When you have clicked on an edit link for a chapter and someone else enters the books Editing 
screen your user name replaces the EDIT link in the Table of contents. This notification 
happens in real time, if you are looking at the overview screen when someone else clicks the 
edit link for one of its chapters you will see the edit button change to their user name. 

REAL TIME CHAT 

Upon entering a book's Editing screen you will see a chat box for that book. The Chat is 
visible for the duration of the time you are editing the book, regardless of which chapter you 
are working on. Anyone else editing the book also has the chat box and you are able to 
communicate with them by typing directly into the text field under the the chat box. This 
feature is very useful for communication with remote participants in Book Sprints as well as 
any situation where contributors to are book are working on it simultaneously. 

Other information is also communicated through the Chat box. When a contributor enters the 
book editing screen a JOINED marker is displayed along with their name in the Chat box. So 
anyone already editing a book can see that someone else has joined them in editing mode and 
they can start communicating. 

Live User Status Listing 

Below the chat box is a Currently editing panel which lists all authors currently working on the 
book. As an added feature of this panel not only is the users name listed but also a "What's 
on your mind ?" statement, which is edited from your Profile page. This statement can help 
communicate to others what you are working on (e.g. "I'm touching up formatting in the 
Introduction"), or how you are feeling (e.g. "Having bad day, don't want to talk.. .TO ANYONE"). 

SYSTEM LEVEL NOTIFICATION 

System Level Notifications are generated when the following actions are performed: 

• When a user saves a chapter 

• When a user creates a new chapter 

• When a user renames a chapter 

• When a user alters the status of a chapter 

• When a user creates a new section 

• When a book is being published 

• When a user saves a book's notes 
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Booki generates and displays the messages in two ways: using the Chat Box and using the 
History Tab in the Editing Page. 

Chat Box 

When one of the above actions is performed the Chat box displays an INFO marker and brief 
description outlining what has taken place. This Notification is extremely useful in a Book 
Sprint environment where several participants are collaborating on a book simultaneously. 
Each participant is kept up to date of others' progress and can instantly reply to any 
notifications using the Chat Box. 

History Tab 

The History tab sits next to the Chapters tab in the Book Editing Page. Clicking to the 
History tab loads up a list of all the edits that have been made to the book (Note: on a 
mature book it can take a while to load the list due to the large number of edits that have 
been made). Every time one of the above actions is performed a new item is added to the 
history tab using a number code to identify what type of action has taken place. The Date 
and time of the action is also recorded. 

If an edit to a chapter has been very minor, for example a spelling correction, the author has 
the option to prevent a history record from being generated when the chapter is saved. This 
is carried out using the Minor change, don't notify tick box at the bottom of the Chapter 
Editing panel. Placing a tick in the box will prevent a history record from being generated 
when the chapter is saved. 

An author also has the ability to add comments to the history record using three text boxes 
below the Minor change, don't notify tick box. The top box is a general comment box, 
followed by an Author text box, where the Author has the option of entering their name. 
The final text box is an Author comment box where the author is able to make another 
note. Comments entered into any of these text boxes will be added to a history record when 
the chapter is saved. 

The records in the history tab can be very useful for working on a book over a long period of 
time where contributing authors are often not logged into Booki at the same time. It can 
display what edits other authors have contributed since the last time a participant logged on 
and help them to decide what areas to work on. This is especially true if the author has added 
comments detailing what they did and what further work they feel is needed in order to 
complete the chapter they have contributed to. 

CHAPTER STATUS MARKERS 

In the Chapters tab of the book editing page, on the right hand side of each chapter bar there 
is a status marker for the chapter. 

This can be manually altered depending on what stage the chapter is up to. Clicking on the 
marker reveals a drop-down list. Click on the list and select the status required for the 
chapter. The chapter's marker is changed to the new status. 

When working on a book that has been created from scratch, the default marker is not 
published. For a book that has been imported from another source, the default status for a 
chapter is imported even for new chapters that have been created from scratch after the 
import. 

BOOK NOTES 
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A books notes are where contributors can discuss and add comments about the book as a 
whole. Anything can be added to a book's notes including a suggested structure or outline for 
a book, which areas need urgent attention and even suggestions for a books direction. Book 
Notes are accessed through the Notes tab on the Book Editing Page. Once there you have a 
free text field to add a much or as little as you want. When you have added your notes, click 
Save the notes at the bottom of the Notes tab to save your changes, an INFO notification will 
be displayed in the Chat box saying that the notes have been saved. 

USE CASE 

You log into Booki to make some additions to your book "Growing Vine Fruit", when you load 
up the Editing page you notice that another member of the Organic Gardening Group is 
already editing a chapter on Pruning as their name appears instead of the Edit Button for the 
Pruning chapter in the Table of contents. You use the chat bot to hi to the other Author and 
two of you have a brief conversation about the structure of the book before start on your 
own edits. 

While you are typing away you suddenly see an INFO icon pop up in the Chat box saying that 
the other Author has saved the chapter "Pruning". A couple of minutes later you see their 
name disappear from the Currently editing panel below the Chat box, this reminds you of 
some ideas that came up in the conversation you had earlier. You think these would be good 
to share with everyone working on "Growing Vine Fruit" so you save your work and then click 
on the Notes tab. In the notes tab you type in a couple of sentences outlining a revised 
structure for the book. Now any other Author will be able to click on the notes tab to find out 
the proposed structure for the book and even make their own notes or additions. 
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17. 



PUBLISHING 



Once a book has been completed or finished to a satisfactory level it can be published. 
Publishing can be sent to several different outputs - not just to standard print formats - each 
with it's own specific needs and uses. 

PUBLISHING FORMATS 

book formatted pdf - book(PDF) 

Used for the creation of printed books, the book(PDF) file can be uploaded to a print on 
demand service or even sent to a local printer for printing of a standard bound book. It can 
also be used for printing a single copy of a book from a domestic printer. 

newspaper formatted pdf - newspaper(PDF) 

This format is used for printing multicolumn texts to large scale newsprint. This can be useful 
for cheaply printing off books using a cheap print format and local printers. 

web formatted pdf - web(PDF) 

This type of production is to be read on screen. It can be added to a website, or downloaded 
for off-line viewing on a computer or any compatible device. 

epub 

epub is used for e-book publication, it generates and e-book using the open epub format. 
Which can be read using any compatible device, including computers with appropriate software 
as well as portable devices such as the Sony Reader and Apple's iPod Touch and iPhone. 

OpenOffice Rich Text format (.odt) 

This output can be opened and edited in OpenOffice.org, enabling extra customisations to be 
added as well as conversion to Microsoft's .doc format for exchange with 3rd parties who 
haven't heard of free software. This can also be a good method of publishing if you want to 
customise the fonts and formatting of your published but aren't proficient in CSS. 

HTML 

the HTML output can be embedded into any website, so an organisation is able to export a 
book to HTML and then embed it into their website. 

PUBLISHING A BOOK 

Once a book is ready from the Book page, click on the Publish tab. You can now set the 
publishing options for your book. 

Simple publication 

If you are happy with just a generic look and feel for your book and your aren't planning on 
selling copies to retail book stores, then all you need is a simple publication. 
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1. Enter a Title for your printed book. 

• by default this is the title used within Booki but it can be changed if required and forms 
the Title Page or cover for the book. 

• Choose the output document type from the drop-down list. 

• Choose a licence for the book from the drop-down list. 

• Place a tick next to archive.org if you want a copy of your book sent there. 

• Click on Publish this book 

Booki will convert your book to the desired document type using objavi and when finished will 
display a link to the generated document. The page size for your book will be Comicbook which 
is 160mm x 260mm and you use a default style set for your fonts and layout. 

Advanced options 

Clicking on Show advanced options reveals a range of extra settings that can be used to 
customise the output of your book. 
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• If you have purchased an ISBN number for your book, you are able to add it using the 
advanced options. 

• A Table of Contents header can be added to your book. If left blank this header will 
default to "Table of Contents". 

• Pre-set book sizes: 



Name 


Dimensions (mm) 


Compatibility 


Lulu 


Newspaper 


ISO standard 


POCKET 


107 x 174 


Yes 






A5 


148 x 210 


Yes 




Yes 


USTRADE 


152 x 228 


Yes 






SQUARE7.5 


190 x190 


Yes 






ROYAL 


155 x 233 


Yes 






LANDSCAPE9X7 


228 x 177 


Yes 






COMICBOOK 


168 x 260 


Yes 






CROWNQUATRO 


189 x 245 


Yes 






SQUARE8.5 


215 x 215 


Yes 






USLETTER 


215 x 279 


Yes 






A4 


210 x 297 


Yes 




Yes 


Foolscap (F4) 


210 x 330 








B4 


250 x 353 






Yes 


Oamaru Tabloid 


265 x 380 




Yes 




UK Tabloid 


279 x 431 




Yes 




A3 (NZ Tabloid) 


297 x 420 




Yes 


Yes 


Berliner 


315 x 470 




Yes 




B3 


353 x 500 






Yes 


Oamaru 
Broadsheet 


382 x 540 




Yes 




US Broadsheet 


380 x 577 




Yes 




A2 (NZ 
Broadsheet) 


420 x 594 




Yes 


Yes 


UK Broadsheet 


457 x 609 




Yes 




B2 


500 x 707 






Yes 


A1 


594 x 841 






Yes 


B1 


707 x 1000 






Yes 



If none of the pre-set page sizes fits your requirements you also have the ability to 

enter custom page sizes with the Width and Height settings. 

Margins can be customised using the Top, Bottom and Side Margin Settings. When 

publishing to Book(PDF) you can also customise the Gutter which is the inner margin of 

two facing pages in a bound book. The gutter will be lager than the Side Margin to allow 

for space taken up by the binding process. 

If you want to print multi columned pages such as when printing to newspaper, you can 

use the Columns and Column margin settings to define how many columns you want 

per page and the amount of space between each column. 

You are able to set the style for you book using the CSS mode. You can select either 

Server default or custom. With custom selected a text box is displayed where you 

are able to edit and modify the CSS used to generate your book. For a list of the fonts 

available when customising your CSS see the Appendix. 

At the bottom of the advanced options you can select Grey-scale for use when printing 

with only black and white such as printing to newsprint. 
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USE CASE 

Web Publishing 

Since joining the Organic Gardening Group on Booki it membership has grown quite remarkably 
and has now developed it's own website which offers pdf downloads of it's completed 
manuals. You have just finished writing Growing Vine Fruit and now wish to publish it for 
inclusion in the Groups website. 

1. You navigate to the editing page for Growing Vine Fruit and click on the Publish tab. 

2. Leaving the Book title as Growing Vine Fruit you select web (PDF) as your Document 
type and CC-BY-5A as your License. 

3. Deciding that it would be useful Archive.org to have a copy of your book you leave the 
tick in the box next to send to archive.org 

4. Without needing to customise the publishing process any further you click on Publish 
this book. 

5. You see a progress bar slowly fulling up as you Booki sends Growing Vine Fruit to 
Objavi to be published to PDF. 

6. When the process is finished there is a link to the new book at the bottom of the page. 
You click on the link to download the published book to your computer which you later 
upload to the Organic Gardening Groups website. 

Newspaper Publishing 

In two weeks you will be manning a stall at a local farmer's market. Among the items being 
sold at the stall are grapes from your grape vine. You think it could be a good idea to have 
copies of Growing Vine Fruit to sell along side your grapes. After calling some local printers you 
find one that can do a small print run onto news print for you at a reasonable price, you just 
have to supply him with a pdf of your book formatted for news print. 

1. You navigate to the Publish tab for Growing Vine Fruit. 

2. Leaving your Book title as Growing Vine Fruit you select newspaper (PDF) as your 
document type and CC-BY-SA as your License. 

3. For Booki to publish to newspaper (PDF) correctly you will need to adjust some advanced 
settings so you click on Show advanced options. 

4. You select A3 (NZ Tabloid) for your page size as that was the size the local printer 
requested. 

5. You want 2 columns in your newspaper book so you type in 2 next to Columns and then 
5 next to Column margin to give a 5mm margin between your columns. 

6. Finally you place a tick next to Grey-scale since you have restricted yourself to black 
and white printing to reduce costs. 

7. You click on Publish this book and shortly a link is created to your newspaper (PDF) 
book. You download this link before emailing the pdf document to your local printer. 

Book Publishing 

Your newspaper formatted book proved very successful at the farmers market and you 
decide to set up an account with Lulu to sell print on demand versions of your book. After 
checking out their website and creating an account you decide to use the A5 paper size 
creating a handy sized book with Binding. 
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1. After navigating to the Publish tab you leave the Book title as Growing Vine Fruit, you 
select book (PDF) for the Document type and CC-BY-SA for your License. 

2. You click Show advanced options and type in Growing Vine Fruit - Contents as your 
Table of Contents header. 

3. You select A5 for your Page size. 

4. Under CSS mode you select custom. A text box opens up containing the Default CSS for 
you to edit. You were wanting to change the font-family for the body so on the font- 
family line under body you Gillius ADF and replace it with DejaVu Sans. 

5. You also want the title of the book's front page to stand out so you scroll down the CSS 
text box to hi. frontpage and then add the line font-family: "Century Schoolbook L"; to 
hi. frontpage. 

6. You click on Publish this book and once the link has been generated you download the 
book formated pdf to your computer before uploading it to Lulu.com 

Epub Publishing 

While you were setting up Growing Vine Fruit on Lulu for print on demand you noticed that 
they also sell ebooks, thinking that this could be another good avenue for getting the 
knowledge out there you decide to generate an epub version of your book to add to your Lulu 
site. 

1. Under the Publish tab for Growing Vine Fruit you leave the Book title as is. 

2. You select epub for your Document type and CC-BY-SA as your License. 

3. Since you already sent a copy of your book to Archive.org you remove the tick from 
send to archive.org. 

4. With no advanced options needed you click on Publish this book and download the epub 
document once the publication process has finished, before adding it to your Lulu site. 

OpenOffice Publishing 

A few months after setting up your Lulu account you have had plenty of traffic obtaining 
copies of your book and now a local publisher has approached you about printing a run of 
Growing Vine Fruit. Over a few weeks of talking with them you have come up with a book 
design and have finally convinced them to use the CC-BY-SA license that you have been using 
so far. Although the content remains the same, there will be some stylistic changes made for 
the new book. Firstly the book size is not one of the standard sizes available from Booki, it 
will be a small hand held text being thinner and taller than standard formats. Next the font 
for the body text will be Century Gothic which is currently not available on the Booki server. 
There will also need to be some forced page breaks entered to keep sub headings on the 
same page as their content. A final formatting change is to wrap the text around pictures 
where possible. Lastly the publisher's printing software requires the book text to be in 
Microsoft Word's .doc format. Since several of these formatting requirements are unavailable 
through CSS alterations you decide to publish Growing Vine Fruit to OpenOffice format, you 
can then load up the file in OpenOffice and apply the required formatting edits there before 
saving the document to .doc format and sending to the publisher. 
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1. On Growing Vine Fruit's Publish tab you leave the title as is, change the document type 
to openoffice, change the License to CC-BY-SA, remove the tick from send to 
archive.org and then click on Show advanced options. 

2. You enter the ISBN number supplied by your publisher and then change the Page size to 
custom. 

3. You enter a Page width of 100 and a page height of 200 

4. All measurements are taken in mm. 

5. You enter 10 for the Top margin, Side margin and bottom Margin 

6. You type in 25mm for the Gutter. 

7. You now click on Publish this book. 

8. Once the document has been created you download it and make all required formatting 
changes in OpenOffice before saving to a .doc file and sending to your publisher. 
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18. 



LICENSING 



When you create a book or upload an image with Booki, you must choose a license that 
defines how the content can be used. 

Legally, writers should understand the license under which the content can be used, and follow 
the licensing instructions when sharing content. Copyright law, which varies by country, gives 
the original creator exclusive rights to do with the content as they please. A writer might give 
someone one-time printing rights for an article or essay. A photographer might display a photo 
on Flickr but mark it with a certain license that indicates how you can use it. 

Licensing the content is one of the things the copyright holder can do with the content to 
indicate how they, the creator, give permission for it to be used, sold, distributed, and so 
forth. 

The phrases a€oeopen contentaC or "free content" are used a lot when talking about content 
that is liberally licensed. The term "open source" is sometimes used in the same way but 
typically "open Source" applies to software. 

One of the key organisations pushing open content licenses is Creative Commons. Creative 
Commons was established to create and promote open licenses for content. It has four 
licenses that are explained in straightforward language on their website 
(http://creativecommons.org/about/licenses). The most accommodating requires only 
attribution. Then there are more restrictive mixes and matches that enable different 
commercial uses, whether you must share any derivatives, whether you can make a 
derivative, and so on. 

While Creative Commons is important there are also other organisations that have developed 
open content licenses including Mozilla, MIT, the Free Software Foundation and others. 

COPYLEFT VS OTHER LICENCES 

As a play on words the copyleft term means "Some copyrights left" - meaning that creators 
can use copyright law to enable distributed copies, revision rights, sharing rights, and so on. 

- explain "All rights reserved" 

PUBLIC DOMAIN 

- not always possible, in many countries it's impossible for the creator to forgo rights 

- CCO is one approach 

- explain that this means you forgo all rights to the work 

- add a note that CC-BY would provide wide dissemination, and you would still be recognised 
as the creator of the work 

COPYLEFT LICENCES 

- CC-BY-SA (unported?) 
Non-copyleft licences 

- CC-BY 

Including software code? 

- Provide a recommendation to use code-specific licences (GNU GPL, MIT) 

- Direct people to http://opensource.org/ 
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CONTRIBUTING TO BOOKI 



19. HOW WE WORK 

20. BUG REPORTING 
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19. 



HOW WE WORK 



We are happy to extend our core team in time to include others that are enthusiastic about 
the project and can commit the time and energy. Currently we are a small team consisting of 
just the following members : 

Adam Hyde - Project Manager 
Aleksandar ErakoviAt - Progammer (Booki) 
Douglas Bagnall - Programmer (Espri, Objavi) 

There are several others involved such as Jan Gerber and Andy Cat. We also work closely with 
the Archive.org team on several issues including epub import and export of content directly to 
the Archive.org servers. 

The development of the FLOSS Manuals platform was really a process of experiencing first 
hand what is needed to develop Free Software manuals through two processes : 

1. Community and individual writing of documentation 

2. Book Sprints 

With FLOSS Manuals the team would work with the community and Book Sprint teams 
creating documentation and then discuss what works and doesn't work and extend the 
platform accordingly. Sometimes this was done with the assistance of project funding, and 
sometimes without. In all cases we preferred (and still do) utility over complicated design. KISS. 

We have now ceased work on the FLOSS Manuals platform to develop Booki and I think its fair 
to say that while the FM platform is fully functional and productive, we see it not as a 'finished' 
work but as a prototype and our primary feature-set design document for the current Booki 
development. 

This short pre-history also explains our preferred development methodology. Although we do 
have milestones and we have a pretty clear idea of what we want to build, much of the detail 
and new ideas are worked out in discussion in IRC. If you wish to contribute to the code base 
then the process of getting involved is more about engaging with the resources listed below 
and asking questions than it is about reading our (non-existing) design documentation. 

If you wish to help fix existing features please look at the Trac tickets. 

You can also read the section 'How You Can Help' if you wish to tackle implementing new 
features. 

The following are the main channels for communication and for getting the code. 

RESOURCES 

IRC : irc.freenode.net #fm-tech 

Email : http://lists.flossmanuals.net/listinfo.cgi/booki-dev-flossmanuals.net 

Code 

http://booki-dev.flossmanuals.net/git 

Here you will find the repositories for Booki, Objavi and Espri 

Trac 
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http://booki-dev.flossmanuals.net/ 
Primary Install 

http://www.booki.cc 

FLOSS Manuals 

http://www.flossmanuals.net 
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20. 



BUG REPORTING 



Bug Reporting - believe it or not, there are people out there that love bug reporting. If you are 
one of those people - we need you! 

HOW TO REPORT A BUG 

We use the a software called Trac' for reporting and managing bug reports. To contribute you 
must first create an account. You create an account on the Booki Bug Tracking (Trac) site at 
the following URL: 

http://booki-dev.flossmanuals.net/register 

Once you have done that you will need to open a new 'ticket'. In this instance a 'ticket' is just 
another word for 'bug report'. You can click on the 'New Ticket' link located at the top right of 
any page in Trac. If you don't see this link then you are probably not logged in. 

You will see a form with several fields : 

■ 

Here are some tips on what to put in each field: 

Summary - give a brief summary of the bug in no more than a dozen words. Keep it brief and 
descriptive. This in itself is an art! 

Reporter - this should automatically display your name and you should not alter this 
information. 

Description - describe the bug in much detail as possible. Be as specific as possible and 
provide information so that the developers can recreate the same error if possible. Don't 
worry about supplying too much information - put in here as much as you like. Additionally, if 
the bug has displayed an error message, copy and paste the entire message at the end of the 
description. 

Type - leave this as 'defect' (bug). 

Milestone - leave this as 'Bugs'. 

Keywords - add a few keywords to help people find all bugs related to a specific topic using 
the search system in Trac. You could use keywords like 'registration' if the bug was found 
during the registration process, 'editing' if the bug while discovered while editing a book etc. 
You can provide many keywords but make sure they are all separated by a comma 

Assign to - leave this blank (used by the developers) 

Priority - you can set this as you like, probably someone will come by later (the 'bug 
manager') and set the priority level again. 

Component - probably you will want to leave this set as 'Booki'. Only if you are testing Objavi 
(the publishing engine) will you need to set this as Objavi. 

Cc - leave this as it is displayed. If you wish to be informed of any changes to this bug report 
then add your Trac username and the end of this list preceded by a blank space. 
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Once all is filled out press 'Create ticket'. ..now pat yourself on the back and find more bugs to 
report! 
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APPENDIX 

21. APPENDIX - FONTS AVAILABLE FOR PUBLISHING 



43 



21. APPENDIX - FONTS AVAILABLE FOR 
PUBLISHING 
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A_Nefel_Adeti 

A_Nefel_Adeti_Qelew 

A_Nefel_Botan 

A_Nefel_Sereke 

A_Nefel_Sereke_Qelew 

Abecedario 

Abecedario_guiada 

Abecedario_pautada 

Abecedario_punt-guiada 

Abecedario_punt-pautada 

Abecedario_punteada 

AI_Mushaf 

Aladdin 

AlArabiya 

AlBattar 

Aleem Urdu Unicode 

Alfa -beta 

AlHor 

AIManzomah 

AIMateen-Bold 

AIMohanad 

AIMothnna-Bold 

Alvi Nastaleeq 

AIYarmook 

Andale Mono 

Andalus 

Andika Basic 

API PHONa€|TIQUE 

Arab 

Arabic Typesetting 

Arabic Web 

ArabicKufiOutlineSSK 

ArabicKufiSSK 

ArabicNaskhSSK 

ArabicRiyadhSSK 

ArabicZibaSSK 

Arial 

Arial Black 

Atari 

AtariSmallBold 

AtariSmallCondensed 

AtariSmallltalic 

AtariSmallLight 

Aurelis ADF 

Aurelis ADF Cd 

Aurelis ADF Demi 

Aurelis ADF Ex 

Aurelis ADF Ex Demi 

Aurelis ADF Light 

Aurelis ADF Script 

Aurelis ADF Script No2 

B Arabic Style 

B Arshia 

B Compset 

B Davat 

B Elham 
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B Esfehan 

B Fantezy 

B Farnaz 

B Ferdosi 

B Homa 

B Jadid 

B Kamran 

B Kamran Outline 

B Koodak 

B Koodak Outline 

B Majid Shadow 

B Nasim 

B Roya 

B Sina 

B Tabassom 

B Tawfig Outline 

BTitr 

B Traffic 

B Yagut 

B Yekan 

BZar 

BABEL Unicode 

Balker 

Baskervald ADF Std 

Baskervald ADF Std Heavy 

Berenis ADF 

Berenis ADF Cd 

Berenis ADF Med 

Berenis ADF No2 

Berenis ADF No2 Cd 

Berenis ADF No2 Style 

BetecknaLowerCase 

BetecknaLowerCaseBold 

BetecknaLowerCaseBoldCondensed 

BetecknaLowerCaseCondensed 

BetecknaLowerCaseltalic 

BetecknaLowerCaseltalicCondensed 

BetecknaLowerCaseLight 

BetecknaLowerCaseLightCondensed 

Bitstream Cyberbit 

Bold Italic Art 

Century Schoolbook L 

Charis SIL 

Comic Sans MS 

Cortoba 

Courier New 

DejaVu Sans 

DejaVu Sans Condensed 

DejaVu Sans Light 

DejaVu Sans Mono 

DejaVu Serif 

DejaVu Serif Condensed 

Dimnah 

Dingbats 

Diwani Bent 

Diwani Letter 
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Diwani Outline Shaded 

Diwani Simple Outline 

Diwani Simple Outline 2 

Diwani Simple Striped 

Domestic Manners 

Doulos SIL 

Dustismo 

Dustismo Roman 

El Abogado Loco 

Electron 

Elegante 

Elham 

Ellhnikh 

EMERITA Latina 

Essays1743 

Ezra SIL 

Ezra SIL SR 

Farsi Simple Bold 

Farsi Simple Outline 

flatline 

FreeFarsi 

FreeFarsi Monospace 

FreeMono 

FreeSans 

FreeSerif 

Furat 

Futura 

Galliard 

Gentium 

Gentium Basic 

Gentium Book Basic 

GentiumAlt 

Georgia 

Gill Sans 

Gill Sans Condensed 

Gill Sans Extra Bold 

Gill Sans Light 

Gill Sans MT 

Gillius ADF 

Gillius ADF Cd 

Gillius ADF No2 

Gillius ADF No2 Cd 

GlobalScience 

Goher Urdu Unicode 

Goudy Bookletter 1911 

GoudyBookletter1911Bold 

Goudy Bookletter1911BoldCondensed 

Goudy Bookletter1911Condensed 

GoudyBookletter1911ltalic 

Goudy Bookletter1911ltalicCondensed 

GoudyBookletter1911Light 

Goudy Bookletter1911LightCondensed 

Granada 

Graph 

Hani 

Haramain 
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HelvCondensed 

Helvetica 

Homa 

Hor 

Ikarius ADF 

Ikarius ADF No2 

Impact 

Inconsolata 

IPA PHONETICS 

IrnafontJ 

IrnafontJO 

lrnafont_11 

lrnafont_2 

lrnafont_4 

lrnafont_5 

lrnafont_6 

lrnafont_7 

lrnafont_8 

lrnafont_9 

It wasn't me 

Italic Outline Art 

ITC Galliard 

Japan 

Jara 

jet 

Junicode 

Junicode-BoldCondensed 

Junicode-BoldltalicCondensed 

Junicode-ltalicCondensed 

Junicode-RegularCondensed 

Junkyard 

KacstArt 

KacstBook 

KacstDecorative 

KacstDigital 

KacstFarsi 

KacstLetter 

KacstNaskh 

KacstOffice 

KacstOne 

ka est Pen 

KacstPoster 

KacstQurn 

KacstScreen 

KacstTitle 

KacstTitleL 

Kayrawan 

Khalid 

Koodak 

Lateef 

Led Italic Font 

Liberation Mono 

Liberation Sans 

Liberation Serif 

Libris ADF 

Linux Libertine 
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Linux Libertine C 

Marked Fool 

Mashq 

Mashq-Bold 

Metal 

MgOpen Canonica 

MgOpen Cosmetica 

MgOpen Modata 

MgOpen Moderna 

Mothanna 

Mothanna-Bold-Oblique 

Mothanna-Oblique 

mry_KacstQurn 

Nada 

Nafees Nasq 

Nafees Nastaleeq 

Nafees Riqa vl.O 

Nafees Tahreer Naskh vl.O 

Nafees Web Naskh 

Nafees Web Naskh pakistani BTK 

Nagham 

Naqsh 

Nastaleeq Like 

Nazli 

New 

Nice 

Nimbus Mono L 

Nimbus Roman No9 L 

Nimbus Sans L 

NWNaskh 

OCRA 

OCRABold 

OCRACondensed 

OCRAItalic 

OCRALight 

Old Antic Bold 

Old Antic Decorative 

Old Antic Outline 

Old Antic Outline Shaded 

OpenSymbol 

Ostorah 

Ouhod-Bold 

Padauk 

Pak Nastaleeq 

PakType Ajrak 

PakType Naqsh 

PakType Naskh Basic 

PakType Naskh Basic Farsi 

PakType Tehreer 

Palatino Linotype 

Pars Ziba - Draft 

Pashtu Abdaali 

Pashtu Breshnik 

Pashtu Kandahar 

Pashtu Waziristan 

Penguin Attack 



49 



Persian 

Persian Web 

Petra 

progenisis 

PT Bold Arch 

PT Bold Broken 

PT Bold Dusky 

PT Bold Heading 

PT Bold Mirror 

PT Bold Stars 

PT Separated Baloon 

PT Simple Bold Ruled 

Quercus 

Rasheeq-Bold 

Rehan 

Riwaj 

Romande ADF Std 

Romande ADF Style Std 

Roya 

Salem 

Scheherazade 

Shado 

Sharjah 

Siddiqua 

Simple Bold Jut Out 

Simple Indust Outline 

Simple Indust Shaded 

Simple Outline Pat 

Simplified Arabic 

Simplified Arabic Fixed 

Sindbad 

Standard Symbols L 

Summersby 

Swift 

Switzera ADF 

Switzera ADF Bold 

Switzera ADF Cd 

Switzera ADF Ex 

Switzera ADF Extra Bold 

Switzera ADF Light 

Switzera ADF Light Cd 

Switzera ADF Reverted 

Tafseer 

Tarablus 

Terafik 

Thabit 

Tha bit-Bold 

Tha bit-Bold-Oblique 

Tha bit-Oblique 

Tholoth 

Times New Roman 

Tiresias Infofont 

Tiresias Infofont Z 

Tiresias Keyfont V2 

Tiresias LPfont 

Tiresias PCfont 
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Tiresias PCfont Z 

Tiresias Signfont 

Tiresias Signfont Z 

Titr 

Traditional Arabic 

Trebuchet MS 

Tribun ADF Med Std 

Tuffy 

UKIJ Merdane 

UKIJ Nasq 

UKIJ Nasq Zilwa 

UKIJ Tuz 

unifont 

Urdu Naqsh 

Urdu Nasq 

Urdu Nastaliq Unicode 

Urdu_Emad_Nastaliq 

URW Bookman L 

URW Chancery L 

URW Gothic L 

URW Palladio L 

Verdana 

Wargames 

Webdings 

Winks 

X Andalus 

X Arabic 

X Arash 

XAria 

X Arshia 

X Babak 

XBadr 

X Bam 

X Bijan 

X Compset 

X Davat 

X Dorosht 

X Elham 

X Esfehan 

X Fantasy 

X Farnaz 

X Farsi 

X Ferdosi 

X Forouzan 

XGity 

X Homa 

XJadid 

XJalal 

XJohar 

X Kamran 

X Kaveh 

X Kerman 

X Khorsheed 

X Koodak 

XKufi 

X Mahsa 
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X Majid 

X Mashgh 

X Mitra 

XMoj 

X Morvarid 

X Nahid 

X Narm 

X Naskh 

X Nazanin 

X Nima 

X Nimrooz 

X Paatch 

X Persian 

X Roya 

X Sahra 

X Shafigh 

X Shiraz 

X Simin 

X Sina 

X Sousan 

X Tabassom 

X Tawfig 

X Termeh 

X Thulth 

XTir 

X Titre 

X Traffic 

X Vahid 

X Vosta 

X Yagut 

X Yas 

X Yekan 

XZar 

XZiba 

XB Kayhan 

XB Kayhan Navaar 

XB Kayhan Pook 

XB Kayhan Sayeh 

XB Khoramshahr 

XB Niloofar 

XB Riyaz 

XB Roya 

XB Shafigh 

XB Shafigh Kurd 

XB Shafigh Uzbek 

XB Shiraz 

XB Sols 

XB Tabriz 

XB Titre 

XB Titre Shadow 

XB Yagut 

XB Yas 

XBZar 

XM Traffic 

XM Vahid 

XM Yermook 
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Thanks for reading! 

Visit http://flossmanuals.net to make corrections or to find more manuals. 



